home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / viewers / gifkit11 / gifcolor.doc < prev    next >
Text File  |  1990-02-22  |  3KB  |  57 lines
  1. GIFCOLOR
  2.   version 1.2, portable
  3.   11/16/89
  4.   by James W. Birdsall
  5.  
  6.   GIF and "Graphic Interchange Format" are trademarks (tm) of
  7.   CompuServe, Inc., an H&R Block company.
  8.  
  9.  
  10.   GIFCOLOR [[-v|a|d[v]] [target]] [-c[v|f[nnn]] file1 file2]
  11.  
  12.   This program reads and returns information about the global color
  13.   map in a GIF file. With no options, it returns the number of unique
  14.   colors versus the size of the color map, the background color index
  15.   and RGB value, and the RGB value and number of repetitions of each
  16.   repeated color. In this context, "unique color" means that the first
  17.   instance of any RGB value is recognized and any repetitions of it
  18.   thereafter are pretty much ignored; that is, two or more color map
  19.   entries with identical RGB values are treated as one color.
  20.  
  21.  
  22.   ONLY ONE OPTION MAY BE USED. THE OPTION MUST BE FIRST ARGUMENT.
  23.  
  24.  
  25.   -v   VERBOSE  appends all unique RGB values in the color map.
  26.   -a   ALL      appends all RGB values in the color map, in the order
  27.                 in which they appear
  28.   -d   DISPLAY  --DOS WITH VGA ONLY-- appends a display of all unique
  29.                 RGB values, marked with RGB values.
  30.   -dv  DISPLAY VERBOSE
  31.                 --DOS WITH VGA ONLY-- appends a display of all RGB
  32.                 values, marked with RGB values and index.
  33.   -c   COMPARE  compares unique values in two color maps. Returns
  34.                 different, effectively identical (unique colors
  35.                 match), or one map is a subset of the other.
  36.   -cv  COMPARE VERBOSE
  37.                 compares two color maps byte by byte. Returns
  38.                 identical or different.
  39.   -cf[nnn] COMPARE FUZZY [WITH TOLERANCE nnn]
  40.                 compares unique values in two color maps by searching
  41.                 for best match and checking if best match is within
  42.                 given tolerance (default is 10). Returns different,
  43.                 fuzzily identical, or one map is a fuzzy subset of
  44.                 the other.
  45.  
  46.   TARGET may be a filename, a filename with wildcards, or a path.
  47.   FILEn  is a filename, optionally including a path.
  48.  
  49.    The "Press any key..." prompt is automatically suppressed when stdout is
  50.   redirected. Stdout cannot be redirected if any display (-d) option is used.
  51.  
  52.    GIFCOLOR can accept a list of targets from stdin. If stdin is redirected,
  53. GIFCOLOR parses any command line options and then reads targets from stdin
  54. ONLY -- all command line targets are discarded. This list may come from GIFLS
  55. or from a file. Targets must be separated by a newline. Stdin cannot be
  56. redirected if any compare (-c) option is used.
  57.